chore(sub-second): mark upgrade as live on mainnet, document TonAPI streaming by novusnota · Pull Request #2073 · ton-org/docs

novusnota · 2026-04-09T20:53:23Z

Closes #2069

Summary by CodeRabbit

Documentation
- Sub-second finality declared live on mainnet (Apr 9, 2026) with updated integration and recommended-stack guidance
- Requests vs. Streaming docs split; API comparison tables reorganized and reference links cleaned up
- TonAPI Streaming API added as a compatible option alongside TON Center; endpoints and auth notes clarified
- Self-hosting, streaming guidance, and throughput phrasing updated (indexer ~6.25x)
- Corrected casing for “TonAPI” across docs

mintlify · 2026-04-09T20:53:27Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify-ton-docs	🟢 Ready	View Preview	Apr 9, 2026, 8:55 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

coderabbitai · 2026-04-09T20:53:39Z

📝 Walkthrough

Walkthrough

Documents sub-second finality as live on TON mainnet, adds TonAPI Streaming API compatibility/auth notes across streaming docs, restructures the API overview into polling and streaming sections with reference links, and adds a casing override for TonAPI in spellcheck config.

Changes

Cohort / File(s)	Summary
Spellcheck Configuration `\.cspell.jsonc`	Added spelling override mapping `TONAPI->TonAPI` to enforce preferred casing in Markdown/MDX.
API Overview `ecosystem/api/overview.mdx`	Replaced single comparison table with separate Requests (polling) and Streaming tables; converted inline URLs to reference-style link targets and expanded the References section.
Streaming Compatibility Notes `ecosystem/api/toncenter/streaming/overview.mdx`, `ecosystem/api/toncenter/streaming/sse.mdx`, `ecosystem/api/toncenter/streaming/wss.mdx`	Inserted notes stating TonAPI provides compatible SSE/WebSocket streaming endpoints, listed example mainnet/testnet URLs, and clarified that Ton Console API keys are used for authentication.
Sub-second Finality Status & Guidance `ecosystem/subsecond.mdx`	Updated status to live on mainnet (Apr 9, 2026), reworded status/throughput guidance (including ~6.25x indexer throughput), broadened streaming guidance to include TonAPI, adjusted self-hosting and recommended stack instructions and endpoints.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

fix(sub-second): set correct speed and interval numbers #2066: Related edits to ecosystem/subsecond.mdx adjusting sub-second finality guidance and wording.
fix(sub-second): set correct blocks per second #2068: Related updates to ecosystem/subsecond.mdx addressing throughput and timing language.
feat(toncenter): document Streaming API v2 #2049: Prior addition of TON Center Streaming API docs; this PR extends those pages with TonAPI compatibility notes.

Suggested reviewers

tsivarev
aigerimu

Poem

🐇 A hop, a stream, the blocks align,
TonAPI sings in matching time,
Docs split neat and spellings bright,
Mainnet's quick — the world takes flight! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	⚠️ Warning	The PR includes a minor out-of-scope change: a spellcheck configuration update in .cspell.jsonc adding TONAPI->TonAPI mapping, which is not directly required by issue `#2069`.	Consider removing the .cspell.jsonc change or document its necessity, as it appears unrelated to the primary objective of updating sub-second finality documentation.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check	✅ Passed	The PR addresses all coding requirements from issue `#2069`: updates the sub-second finality page to reflect mainnet status and adds TonAPI streaming information across relevant documentation pages.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check	✅ Passed	The title accurately summarizes the two main changes: marking the sub-second finality upgrade as live on mainnet and documenting TonAPI streaming compatibility.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch closes-2069/its-alive

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

github-actions

Thanks for the updates to ecosystem/subsecond.mdx: there are a couple of suggestions around upgrade status wording and concreteness; please apply the inline suggestions.

ecosystem/subsecond.mdx

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@ecosystem/subsecond.mdx`:
- Around line 17-23: Replace ambiguous "today" labels and compact timing units
in the table and nearby text: change strings like "Mainnet today" and "Testnet
today" to an explicit date label (e.g., "Mainnet (YYYY‑MM‑DD)" / "Testnet
(YYYY‑MM‑DD)") and normalize unit spacing to SI-style with a space (e.g., "400
ms" not "400ms", "2.5 s" not "2.5s", "~0.4" -> "~0.4 s" where appropriate).
Update the table rows and any other occurrences (including the other instance
noted around line 25) so all timing values consistently use spaced units and the
relative "today" wording is replaced by the chosen explicit date label.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9388aedf-1865-4ee2-9957-98fd945a4937

📥 Commits

Reviewing files that changed from the base of the PR and between f372205 and 1d3bddd.

📒 Files selected for processing (6)

.cspell.jsonc
ecosystem/api/overview.mdx
ecosystem/api/toncenter/streaming/overview.mdx
ecosystem/api/toncenter/streaming/sse.mdx
ecosystem/api/toncenter/streaming/wss.mdx
ecosystem/subsecond.mdx

ecosystem/subsecond.mdx

chore(sub-second): live on mainnet, TonAPI streaming

1d3bddd

novusnota requested a review from a team as a code owner April 9, 2026 20:53

mintlify bot deployed to staging April 9, 2026 20:55 View deployment

github-actions bot reviewed Apr 9, 2026

View reviewed changes

ecosystem/subsecond.mdx Outdated Show resolved Hide resolved

ecosystem/subsecond.mdx Outdated Show resolved Hide resolved

coderabbitai bot reviewed Apr 9, 2026

View reviewed changes

ecosystem/subsecond.mdx Outdated Show resolved Hide resolved

slight edits

2b1648a

novusnota requested review from TrueCarry and thekiba April 9, 2026 21:06

mintlify bot deployed to staging April 9, 2026 21:06 View deployment

novusnota changed the title ~~chore(sub-second): live on mainnet, TonAPI streaming~~ chore(sub-second): mark upgrade as live on mainnet, document TonAPI streaming Apr 9, 2026

novusnota requested review from aigerimu and tsivarev April 9, 2026 21:09

aigerimu approved these changes Apr 10, 2026

View reviewed changes

novusnota merged commit c797f44 into main Apr 10, 2026
19 checks passed

novusnota deleted the closes-2069/its-alive branch April 10, 2026 11:38

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(sub-second): mark upgrade as live on mainnet, document TonAPI streaming#2073

chore(sub-second): mark upgrade as live on mainnet, document TonAPI streaming#2073
novusnota merged 2 commits intomainfrom
closes-2069/its-alive

novusnota commented Apr 9, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

mintlify bot commented Apr 9, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Apr 9, 2026 •

edited

Loading

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Suggested reviewers

Poem

❌ Failed checks (1 warning)

Uh oh!

github-actions bot left a comment

Uh oh!

Uh oh!

Uh oh!

coderabbitai bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

novusnota commented Apr 9, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

mintlify bot commented Apr 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Apr 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Suggested reviewers

Poem

❌ Failed checks (1 warning)

Uh oh!

github-actions bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

novusnota commented Apr 9, 2026 •

edited by coderabbitai bot

Loading

mintlify bot commented Apr 9, 2026 •

edited

Loading

coderabbitai bot commented Apr 9, 2026 •

edited

Loading